﻿<UserControl x:Class="GrooveSharp.HelpText"
             xmlns:local="clr-namespace:GrooveSharp"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
             xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
             mc:Ignorable="d" 
             d:DesignHeight="600" d:DesignWidth="1500">
    <RichTextBox Margin="20" Name="RichTextBoxHelp" 
                                 HorizontalAlignment="Left" VerticalAlignment="Top" 
                                 BorderBrush="Azure" BorderThickness="0" 
                                 IsReadOnly="True" IsTabStop="False">
        <FlowDocument xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
            <!-- http://msdn.microsoft.com/en-us/library/aa970909.aspx  -->
            <Paragraph>
                <Bold>Groove#</Bold> : GrooveSharp
            </Paragraph>

            <Paragraph>
                <Bold>Rationale</Bold>
            </Paragraph>
            <Paragraph>
                There are already 1000 MP3 players... Why to create another one?
            </Paragraph>
            <Paragraph>
                Just for fun, and because I needed one. When I'm listening music I'm often sitting on a distance, reading.
                                I want to see the titles from a distance. So I like to see it full screen, with large titles, and nothing more.
                                I did not find other MP3 players showing titles as large as in my creation;
                                most players display the title quite small (Zune is better but it is still too small).
            </Paragraph>
            <Paragraph>
                This first, version of this MP3 player was created in about 15 minutes, using WPF it is really a piece of cake.
                                After that the program started to grow...
                Adding .M4A (Apple's lossless version) was just allowing another extension! No conversion necessary.
            </Paragraph>

            <Paragraph>
                <Bold>Images</Bold>
            </Paragraph>
            <Paragraph>
                Groove# displays an image (usually a cover artwork) from either the MP3/M4A itself, or from the filesystem. 
                                It will not retrieve the image from the Internet if not found (as Zune or MediaPlayer do), so the image must already be there.
                                It tries to find an image in the next order:
            </Paragraph>
            <List>
                <ListItem>
                    <Paragraph>Embedded in the MP3/M4A</Paragraph>
                </ListItem>
                <ListItem>
                    <Paragraph>From the MP3/M4A filename, but with its extension replaced by .PNG</Paragraph>
                </ListItem>
                <ListItem>
                    <Paragraph>From the MP3/M4A filename, but with its extension replaced by .JPG</Paragraph>
                </ListItem>
                <ListItem>
                    <Paragraph>From a file in the folder where the MP3/M4A is, called GrooveSharp.png</Paragraph>
                </ListItem>
                <ListItem>
                    <Paragraph>From a file in the folder where the MP3/M4A is, called GrooveSharp.jpg</Paragraph>
                </ListItem>
                <ListItem>
                    <Paragraph>From a file in the folder where the MP3/M4A is, called folder.jpg</Paragraph>
                </ListItem>
            </List>
            <Paragraph>
                The very last one is used by WMP or Zune, but you see you can vary a lot more. 
                                For example, if you have an album of which three singles are extracted, you can add an image for the album
                                (normally automatically retrieved on ripping, and called folder.jpg by WMP) and add three other images for each of the singles.
                                These are displayed for those singles only, and for all other tracks the album artwork is displayed.
            </Paragraph>

            <Paragraph>
                <Bold>Ratings</Bold>
            </Paragraph>
            <Paragraph>
                All ratings are stored in the Groove# datastore (an SQLite database). So they are never stored in the MP3.
                                Groove# does not store anything in the MP3, it only read things from it.
                                The nice thing is that ratings
                <Bold>rated on your iPad or iPhone or in iTunes</Bold> can be synchronized with Groove#.
                                You can export them using iTunes, and specify that filename (once) in Groove#.
                                After that ratings and also the last playdate are stored in the Groove# datastore,
                                and the rating stars are displayed during playing the song.
            </Paragraph>

            <Paragraph>
                <Bold>Learn</Bold>
            </Paragraph>
            <Paragraph>
                The intention is to add a quizlike screen as well where the music is played
                                and where the user has to enter which is the played track. As soon as he/she knows it, and
                                he/she gains points for that.
            </Paragraph>

            <Paragraph>
                <Bold>Credits</Bold>
            </Paragraph>
            <Paragraph>
                This program uses Open Source libraries or parts from:
            </Paragraph>
            <List>
                <ListItem>
                    <Paragraph>SQLite</Paragraph>
                </ListItem>
                <ListItem>
                    <Paragraph>Stormy (created by myself)</Paragraph>
                </ListItem>
                <ListItem>
                    <Paragraph>taglib-sharp</Paragraph>
                </ListItem>
                <ListItem>
                    <Paragraph>Josh Smith's ListView Drag and Drop Manager</Paragraph>
                </ListItem>
                <ListItem>
                    <Paragraph>Glassbuttons, from codeproject: http://www.codeproject.com/KB/WPF/glassbuttons.aspx</Paragraph>
                </ListItem>
                <ListItem>
                    <Paragraph>Rounded tabs, from http://www.switchonthecode.com/tutorials/the-wpf-tab-control-inside-and-out</Paragraph>
                </ListItem>
                <ListItem>
                    <Paragraph>Ratings, inspired on http://www.codeproject.com/KB/WPF/WPF_Media_Player.aspx</Paragraph>
                </ListItem>

            </List>

            <Paragraph>
                <Bold>© Barend Gehrels 2011..2012</Bold>
            </Paragraph>

        </FlowDocument>
    </RichTextBox>
</UserControl>
